home *** CD-ROM | disk | FTP | other *** search
/ Mac Expert 1995 Winter / Mac Expert - Winter 95.iso / Les fichiers / Utilitaires divers / Cat & Compresseurs / FileList 1.4 ƒ / FileList.Doc next >
Encoding:
Text File  |  1990-09-14  |  9.8 KB  |  314 lines  |  [TEXT/QED1]
  1. ===========================================================================
  2. "FileList"                                 Macintosh Volume And File Lister
  3. ===========================================================================
  4.  
  5.                         Version 1.4 (14-Sep-1990)
  6.  
  7.  
  8. ___________________________________________________________________________
  9. ABOUT FILELIST
  10.  
  11. First of all, this program is free (but NOT public domain), including the
  12. sources. So don't pay anybody for it. Make sure to include this
  13. documentation when you give the program away.
  14.  
  15. "FileList" is a file and disk organizer. It reads entire volumes and saves
  16. volume and file information. There is an option that enables "StuffIt"
  17. (Classic and Deluxe) and/or "Compactor" archives to be opened and to be
  18. treated like a folder: all files in the archive (including encrypted
  19. entries) will be listed.
  20.  
  21. The collected information can be displayed, sorted by multiple criteria,
  22. searched for, saved as text files (to be printed later on, or to be
  23. imported into databases). Entire volumes can be deleted or renamed. There
  24. is an automatic disk insert/eject mode, meaning any inserted disk (be it a
  25. floppy or a CD-ROM disk) gets scanned then ejected, or any mounted volume
  26. can be added by selecting from a list of on-line volumes.
  27.  
  28. "FileList" is useful for managing large collections of floppy disks, or can
  29. be used to quickly locate files on a big disk, e.g. CD-ROM.
  30.  
  31. Here is what "MacUser" December 1989 said about "FileList 1.2":
  32. "FileList is a basic but very effective file lister. Insert a disk, and its
  33. contents are quickly listed with volume and folder paths, size, dates,
  34. creator and type. The resultant file can be printed, edited, or exported as
  35. text. The data transfers well to databases. FileList is currently the best
  36. of this type of program available."
  37.  
  38. Changes from version 1.3:
  39.  
  40. * Some small bugs were corrected (multiple monitors, font problem, folder
  41.   that only has folders and no files, file count per volume, cancel, file
  42.   server volume).
  43. * Existing volumes are recognized and can easily be replaced in the list.
  44. * Recognize Compactor archives.
  45. * Recognize StuffIt Deluxe archives.
  46.  
  47. "FileList" should run on any Macintosh Plus or newer Macintosh. HFS
  48. (Hierarchical File System) is required, but MFS (Macintosh File System)
  49. disks are supported. I used System 6.05 with MultiFinder 6.1b9 on a
  50. Macintosh Plus and Macintosh IIcx to develop and test the program. The
  51. program was developed with THINK C 4.02 and the source code is available
  52. (on the services where I personnaly upload "FileList" I also upload the
  53. sources).
  54.  
  55.  
  56. ___________________________________________________________________________
  57. WINDOWS
  58.  
  59. There are always two windows: a volume window and a file window. The title
  60. of each window shows how many entries are in the each list. The windows can
  61. be moved around, resized and zoomed. Clicking in the close box sends the
  62. window to the back, showing the other window. The window positions and
  63. sizes can be saved with the options (see options below).
  64.  
  65. Each volume or file entry is on one line. A line can be selected by
  66. clicking on it. Clicking on a selected line deselects the line again. The
  67. "Copy" menu item (or function key F3) copies the selected line to the
  68. clipboard as text.
  69.  
  70. The scroll bars can be used to move around in the list as expected. The
  71. following keyboard keys can be used to navigate:
  72.  
  73. home            Scroll to beginning of list
  74. end             Scroll to end of list
  75. page up         Scroll one page up
  76. page down       Scroll one page down
  77. cursor keys     Scroll one line up/down or column left/right
  78.                 (use the option key to scroll one page left/right)
  79. return, enter   Move to selection
  80.  
  81.  
  82. ___________________________________________________________________________
  83. MENUS
  84.  
  85. *** File Menu ***
  86.  
  87. New
  88.     Clear current list. Create new empty volume and file list.
  89.  
  90. Open...
  91.     Open existing list from existing FileList file.
  92.  
  93. Close
  94.     Same as clicking in the close box of the active window.
  95.  
  96. Save
  97.     Save list into FileList file.
  98.  
  99. Save As...
  100.     Save list into FileList file under new name.
  101.  
  102. Save Text...
  103.     Export list of active window (volumes or files) into text file.
  104.     (Note that text files cannot be opened again by FileList!)
  105.  
  106. Default Windows
  107.     Resize and reposition windows to default settings.
  108.     (Default settings can be set with the Options... dialog)
  109.  
  110. Options...
  111.     Options dialog.
  112.  
  113. Quit
  114.     Quit the application.
  115.  
  116.  
  117. *** Edit Menu ***
  118.  
  119. Undo
  120.     Not used.
  121.  
  122. Cut
  123.     Not used.
  124.  
  125. Copy
  126.     Copy selected line to clipboard.
  127.  
  128. Paste
  129.     Not used.
  130.  
  131. Clear
  132.     If the option key is also pressed this clears both the volume and file
  133.     index tables.
  134.  
  135. Find...
  136.     Find dialog.
  137.  
  138. Find Again
  139.     Find next item.
  140.  
  141. Move To Selection
  142.     Bring selected item into view (same as return or enter key).
  143.  
  144.  
  145. *** Volume Menu ***
  146.  
  147. Automatic
  148.     Select/deselect automatic insert/eject mode.
  149.     (Can also be selected by using the Options... dialog)
  150.  
  151. Add...
  152.     Show on-line (mounted) volumes. Select those to add to list.
  153.  
  154. Delete
  155.     Delete selected volume from the list, and all its files.
  156.     (Note that this deletes the volume in the list, not on the disk!)
  157.  
  158. Rename...
  159.     Rename selected volume.
  160.     (Note that this renames the volume in the list, not on the disk!)
  161.  
  162.  
  163. *** View/Files ****
  164.  
  165. by name
  166. by size
  167. by type
  168. by creator
  169. by created
  170. by modified
  171. by volume
  172. by path
  173.  
  174.  
  175. *** View/Volumes ***
  176.  
  177. by name
  178. by free
  179. by total
  180. by files
  181. by created
  182. by modified
  183.  
  184.  
  185. ___________________________________________________________________________
  186. OPTIONS
  187.  
  188. This dialog presents the following options:
  189.  
  190. * Automatic disk insert/eject
  191.     Anytime a disk is inserted, it is scanned, added to the list, then
  192.     ejected. This works with any movable medium: floppy disks, CD-ROM
  193.     disks, ...
  194.  
  195. * Recognize StuffIt archives
  196.     Anytime a StuffIt archive is found it is treated like a folder, i.e.
  197.     all its files, folders, sub-folders, ... are listed.
  198.  
  199. * Recognize Compactor archives
  200.     Anytime a Compactor archive is found it is treated like a folder, i.e.
  201.     all its files, folders, sub-folders, ... are listed.
  202.  
  203. * Use tabs between fields
  204.     When exporting the list to a text file, tabs are put between fields,
  205.     instead of spaces. This is used to import the data into databases.
  206.  
  207. * Date format
  208.     Select the data format you want. The format selected will be used to
  209.     show the dates on the screen and to export to text files.
  210.  
  211. * Set default window settings
  212.     The current window positions and sizes become the default values.
  213.  
  214. You can press the following buttons:
  215.  
  216. * Ok
  217.     Options take effect but are not saved.
  218.  
  219. * Save
  220.     Options take effect and are saved in a settings file in the System
  221.     folder.
  222.  
  223. * Cancel
  224.     Nothing happens.
  225.  
  226. If you press the option key while choosing the options menu item the
  227. following memory options can be set, but become active only on the next
  228. program start:
  229.  
  230. * Heap size
  231.     The heap size that should remain after "FileList" has allocated all
  232.     it's tables. You should leave at least 30000 Bytes for the heap.
  233.  
  234. * Volumes percentage
  235.     The percentage of how many volume records (any volume, folder and file
  236.     is considered a record) are expected. Clicking on the associated text
  237.     automatically calculates and displays the current volume percentage.
  238.  
  239. * Files percentage
  240.     The percentage of how many file records (any volume, folder and file is
  241.     considered a record) are expected. Clicking on the associated text
  242.     automatically calculates and displays the current file percentage.
  243.  
  244. * Average name size
  245.     Average name size (of volumes, folders and files) expected. Clicking on
  246.     the text automatically calculates and displays the current average name
  247.     size.
  248.  
  249. These values are used by "FileList" to allocate its tables. Everything must
  250. fit into available memory. You can use the "About FileList..." menu item in
  251. the Apple menu to see how memory is allocated. To get more memory under
  252. MultiFinder for longer lists use the Finder's "Get Info" command. E.g. to
  253. be able to list all files on my "EduCorp CD-ROM 4.0" disk containing 14550
  254. files I must set the partition size to 1000 K.
  255.  
  256.  
  257. ___________________________________________________________________________
  258. FIND
  259.  
  260. The find dialog corresponds to the selected window: Files or volumes. For
  261. both you can search by giving part of the name. Enter a string and set one
  262. of the following radio buttons:
  263.  
  264. * Equals
  265.     The search string must be exactly equal to the name.
  266.  
  267. * Starts
  268.     The name must start with the search string.
  269.  
  270. * Includes
  271.     The name must include the search string.
  272.  
  273. * Ends
  274.     The name must end with the search string.
  275.  
  276. That's all for volumes. For files there are two more criteria: file type
  277. and file creator. If the type or the creator is not filled out it is not
  278. used, otherwise it must exactly match (4 characters). One can also use an
  279. empty name string and only find files based on the type and creator, or
  280. type alone, or creator alone, or any possible combination thereof.
  281.  
  282.  
  283. ___________________________________________________________________________
  284. RESOURCES
  285.  
  286. You can use ResEdit to modify the following resources in "FileList":
  287.  
  288. 'STR ' 136      File name for storing options. This file is created in the
  289.                 active System folder. Is set to "Terminal Options". This
  290.                 might be changed to "Preferences:Terminal Options" if you
  291.                 have a "Preferences" folder in your System folder.
  292.  
  293. 'STR ' 138      Creator (4 characters) for text files. Is set to 'PEDT'
  294.                 the creator signature of my text editor.
  295.  
  296.  
  297. ___________________________________________________________________________
  298. COMMENTS
  299.  
  300. Send any comments to:
  301.  
  302. CompuServe  : 73720,2200
  303. Internet    : 73720.2200@compuserve.com
  304. Packet Radio: LX1YZ @ LX0PAC
  305.  
  306. Erny Tontlinger
  307. 33 route d'Arlon
  308. L-8410 Steinfort
  309. Luxembourg
  310.  
  311. Thanks to all those who sent me comments and suggestions for the previous
  312. versions of "FileList". I did not have the time yet to include everything
  313. into this new version, but everything is on the new feature list.
  314.